home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 1 / Gigarom Macintosh Archives (Quantum Leap)(CDRM1080320)(1993).iso / FILES / COP / A-M / Extra Translators 4 SD.sea / Translator Documentation / About MacBinary Translator < prev    next >
Text File  |  1991-01-02  |  10KB  |  260 lines
  1. MacBinary Translator for StuffIt Deluxe
  2.  
  3. Version 1.0 of 91.01.02.
  4.  
  5. Written by Raymond Lau
  6.  
  7. Copyright (C) 1991, Raymond Lau.  All Rights Reserved.
  8.  
  9.  
  10. This software is being licensed to you free of cost.
  11.  
  12. Please see Terms of usage and distribution at the end
  13. of this document for information regarding your right
  14. to use and distribute this software.
  15.  
  16.  
  17.  
  18. Introduction:
  19.  
  20. MacBinary Translator is an external translator for use
  21. with StuffIt Deluxe, available from Aladdin Systems, Inc.,
  22. Deer Part Center, #23A-171, Aptos, CA 95003-4723.
  23. This translator provides compatibility with the MacBinary
  24. format supported by most communications programs for transfer
  25. of files to non Macintosh computers.
  26.  
  27. MacBinary is a file format/transfer protocol that encodes
  28. information about a Macintosh file along with both the
  29. data and resource forks of a file.  With the use of
  30. MacBinary, information such as the file's type (application,
  31. MS Word document, etc) will be preserved even when the 
  32. file is transferred to, say, an IBM PC, and then back
  33. to a Mac.
  34.  
  35. Most telecommunications programs today have built-in support
  36. for MacBinary.  So, in the usual case, you will not need
  37. to use this translator.  However, there are some cases where
  38. you do.  Some of them are listed below.  This list is by
  39. no means complete.
  40.  
  41. When you need this translator:
  42.  
  43. o You have an IBM PC connected to your Macintosh with TOPs.
  44.   You want to transfer Mac files to the PC for distribution
  45.   to other Mac users (say you run a BBS on the PC).  You
  46.   should MacBinary encode your files first so that the
  47.   entire file gets transferred by TOPs.  If not, only
  48.   the data fork, and none of the file information such as
  49.   file type, will be transferred.  When a user downloads
  50.   a file from the PC by modem to her Mac, her
  51.   telecommunications program should automatically recognize
  52.   MacBinary and give her the complete file back.
  53.  
  54. o You've downloaded a file with a communications program, but
  55.   unfortunately, you had the MacBinary option turned off!
  56.   Instead of redownloading the file, you can just use this
  57.   translator to decode it.
  58.  
  59. o You use BinHex5 for whatever reason.  BinHex5 is really a
  60.   MacBinary format.  Files encoded by BinHex5 and this
  61.   translator are interchangeable.  (Note:  BinHex4 is a
  62.   SEPARATE standard.  StuffIt has built in support for
  63.   BinHex4.)
  64.  
  65.  
  66.  
  67. Installation:
  68.  
  69. The rest of this documentation assumes that you have properly
  70. installed StuffIt Deluxe and are familiar with the operation
  71. of StuffIt Deluxe.
  72.  
  73. To install this translator, placed it in the Translators
  74. folder in the System folder of your startup drive.  Then
  75. launch (or quit and relaunch, as appropriate) StuffIt Deluxe.
  76.  
  77. If you are in Standard menu mode, you must switch to Expert
  78. menu mode to use this translator.
  79.  
  80.  
  81. Operation:
  82.  
  83. After installation, you should have a new choice under the
  84. Other menu with the name "MacBinary (BinHex5)."  This item has
  85. 2 subitems.  The subitems are Encode MacBinary... and Decode
  86. MacBinary...
  87.  
  88. To convert a file to the MacBinary format, select
  89. Encode MacBinary.
  90.  
  91. To convert a MacBinary format file back to a standard
  92. Macintosh file, select Decode MacBinary.
  93.  
  94.  
  95.  
  96.  
  97.  
  98. Appendix A: Terms of usage and distribution:
  99.  
  100. Although copyrighted, this software is being licensed 
  101. to you for your use free of charge.  However, ownership
  102. of and interest in this software shall remain with the
  103. author.  Use and distribution of this software is
  104. governed by the following terms in an effort to
  105. reasonably insure that this software will remain
  106. freely available and that no one other than the author
  107. will derive a commercial benefit from distributing
  108. this software.
  109.  
  110.  
  111. LICENSE AGREEMENT
  112.  
  113.  
  114. "You," "your," and the "user" refers to any person or
  115. entity which acquires or uses this software.
  116.  
  117. "Software" refers to any computer programs identified
  118. at the start of this documentation file, together with
  119. all codes, techniques, software tools, formats, designs,
  120. concepts, methods, ideas, and documentation assoicated
  121. with the computer program(s).  The term also includes
  122. all copies of any part of the software and documentation.
  123.  
  124. "Author" refers to the author of this software, Raymond
  125. Lau.
  126.  
  127.  
  128. This software is owned by the author and contains
  129. valuable and proprietary information of the author's.
  130. If you violate any part of this agreement, your right
  131. to use this software terminates automatically.  In the
  132. event of termination of this agreement, you must destroy
  133. all copies of this software and derivatives of this
  134. software in your possession and cease distributing the
  135. same.
  136.  
  137. This software is being licensed to you as provided by
  138. the terms of this agreement.
  139.  
  140. You may:
  141.    1. Use this software on as many computers
  142.       as you want at any given time.
  143.    2. Make as many backup copies of this software as
  144.       you want.
  145.    3. Alter the software in any manner you see fit
  146.       FOR YOUR OWN PERSONAL USE.  Such altered versions
  147.       should not be distributed.  The creation of
  148.       such derivatives shall not diminish the author's
  149.       title to this software.
  150.    4. Terminate this agreement at any time by destroying
  151.       all copies of this software and derivatives of
  152.       this software and cease distributing the same.
  153.  
  154. You may not:
  155.    1. Create any derivative works from this software
  156.       for distribution.
  157.    2. Reverse engineer, disassemble, decompile, or
  158.       otherwise attempt to discover the source code to
  159.       this software.
  160.    3. Use this software in any manner as to discover
  161.       proprietary information relating to the Translator
  162.       interface in StuffIt Deluxe.
  163.  
  164.  
  165. You may distribute this software provided that:
  166.    1. This software is distributed free of any charges
  167.       except as provided for under 1a.  This software may
  168.       not be sub-licensed, sold, lent, rented, or leased
  169.       except as provided for under 1a.
  170.           1a. You may charge a nominal fee to cover
  171.               duplication, shipping and/or handling costs
  172.               of distributing this software provided that
  173.               the pro-rata fee (ex: the fee of ordering a
  174.               disk/CD/tape/etc divided by the number of 
  175.               programs on it) does not exceed US $1.  You
  176.               may include this software in any compilation
  177.               even if you sell the compilation for a
  178.               profit provided that the pro-rata fee defined
  179.               above does not exceed US $1 for this software.
  180.  
  181.               You may also charge your usual timesharing,
  182.               network usage and/or membership fee if you
  183.               distribute this software electronically.
  184.  
  185.               While you may claim a compilation copyright
  186.               on any compilations which include this
  187.               software, interest in and ownership of this
  188.               software shall remain with the author.
  189.             
  190.    2. You include this documentation file with the
  191.       distribution.
  192.    3. You do not modify either this documentation file
  193.       or the software itself.
  194.    4. You do not use the name of this software or
  195.       of the author or the fact that you provide this
  196.       software in any promotional material relating
  197.       to your distribution of this software.  However, you
  198.       may include such information in a catalog listing of
  199.       your offerings.
  200.    5. You may not transfer this software in a manner as
  201.       to violate any regulations relating to the transfer
  202.       of software, including the US Export Administration
  203.       Act.
  204.  
  205. Disclaimer of warranty:
  206.  
  207. In using this software, you understand and agree that this
  208. software is provided "as is" without warranty of any kind.
  209. The entire risk as to the results and performance of using
  210. this software lies entirely with you, the user.  The author
  211. does not make any warranties, either expressed or implied,
  212. including but not limited to implied warranties of
  213. merchantability and fitness for a particular purpose, with
  214. respect to this software.
  215.  
  216. In no event shall the author be liable for any consequential,
  217. incidental, or special damages whatsoever (including without
  218. limitation damages for loss of critical data, loss of profits,
  219. interruption of business, and the like) arising out of the
  220. use or inability to use this software.
  221.  
  222. Although the author would appreciate any feedback and bug
  223. reports, the author shall not be responsible for correcting
  224. any problems which you discover or otherwise help you
  225. maintain and use this software.  Furthermore, the author
  226. may at any time replace, modify, alter, improve, enhance
  227. or change this software.
  228.  
  229.  
  230. Complete agreement:
  231.  
  232. This agreement constitues the entire agreement and supersedes
  233. any prior agreements between you and the author concerning
  234. this software.  This agreement cannot be amended, modified,
  235. or waived except in writing.
  236.  
  237. General:
  238.  
  239. If any provision of this agreement is found to be
  240. unenforcible, it shall be deemed severed from the remainder
  241. of this agreement.
  242.  
  243. This agreement shall be construed in accordance with the laws
  244. of the State of New York.  Any arbitration or litigation
  245. relating to this agreement shall take place in the State of
  246. New York.
  247.  
  248.  
  249.  
  250. U.S. GOVERNMENT RESTRICTED RIGHTS
  251.  
  252. This Software is provided with RESTRICTED RIGHTS.  Use,
  253. duplication, or disclosure by the government is subject to
  254. restrictions set forth in subparagraph (c)(1)(ii) of the
  255. Rights in Technical Data and Computer Software clause at
  256. 48 CFR 252.227-7013, or in subparagraphs (a) through (d) of
  257. the Commercial Computer Software Restricted Rights clause at
  258. 48 CFR 52.227-19, as applicable.  The contractor/manufacturer
  259. is Raymond Lau, 100-04 70 Ave., Forest Hills, NY 11375-5133.
  260.